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TESTING FLOW CONTROL AT TEST ASSERTION LEVEL 

TECHNICAL FIELD 

This invention relates to data processing, and more particularly to test flow control. 

BACKGROUND 

5 Software development is increasingly becoming complex resulting in the possibility for 

errors requiring costly solutions to correct. Software testing plays an important role in helping to 
ensure high software quality and to minimize errors. There are different kinds of testing in a 
software development process. For example, there is functional testing, performance testing, 
load or stress testing, robustness testing and installation testing. Functional testing includes unit 
10 testing, integration (or interaction) testing and acceptance testing. Here the term "unit" refers to a 
technique of testing only individual units of the software system and not the complete software 
system as a whole. 

SUMMARY 

The present invention provides methods and apparatus, including computer program 
15 products, providing test flow control. 

In an aspect, the invention features a method including providing a test hierarchy, the test 
hierarchy including a collection of test methods, each test method calling test assertion methods 
for checking correctness of production code, each test assertion call defining a test execution 
flow within the test hierarchy in an event of a failure and controlling the test execution flow 
20 inside the test hierarchy according to a parameter of the test assertion method call in the event of 
the failure. 

One or more of the following features can also be included. The parameter causes 
instructions to continue or to abort at any level of the test hierarchy after the event. A test 
assertion method includes instructions for verifying an expected state of the production code. 
25 The test hierarchy can be implemented using an object oriented programming language including 
at least one of ABAP (advanced business application program language), Java programming 
language, C++ programming language, or C# programming language. The test hierarchy can be 
implemented using a procedural programming language including at least one of C programming 
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language, FORTRAN programming language and Pascal programming language. The test 
hierarchy can be implemented in a unit test environment. 

In another aspect, the invention features a computer system including a test hierarchy, the 
test hierarchy including a collection of test methods, each test method calling test assertion 
5 methods for checking the correctness of production code, each test assertion call defining the test 
execution flow within the test hierarchy in an event of a failure and a means for controlling a 
flow inside the test hierarchy according to a parameter of the test assertion method call in 
response to the event. 

One or more of the following features can also be included. The test assertion can be 

10 called with a parameter causing the test execution to continue or to abort at any level of the test 
hierarchy after the event. A test assertion method can include instructions for verifying an 
expected state of the production code. The test hierarchy can be implemented using an object 
oriented programming language including at least one of ABAP (advanced business application 
program language), Java programming language, C++ programming language, and C# 

15 programming language. The test hierarchy can be implemented using a procedural programming 
language including at least one of C programming language, FORTRAN programming language 
and Pascal programming language. The test hierarchy can be implemented in a unit test 
environment. 

The disclosed techniques may realize one or more of following advantages. In some 
20 cases, it may be preferable to continue a test even if a test has detected a failure in production 
code. For example, if the test setup is resource and time consuming and if the failure does not 
affect consecutive tests, then it may be preferable to continue a test even in the event of failure 
detection. In other cases, however, a test may have detected a failure in production code making 
remaining tests no longer necessary. For example, the remaining the methods/functions 
25 associated with a test, or the complete test class or even higher levels of tests accumulations may 
produce irrelevant test information. The flow of the execution of test code in a test hierarchy is 
controllable during the execution of the test code. As a result, tests that detect a failure condition 
are avoided if the tests are not relevant or not compatible with a current configuration. 

Other features, objects, and advantages of the invention will be apparent from the 
30 description and appendices, and from the claims. 
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DESCRIPTION OF DRAWINGS 

FIG 1 is a block diagram of a programming environment. 
FIG 2 is test source code and production source code. 
FIG 3 is a diagram of a test hierarchy for testing production code. 
5 FIG 4 is a test assertion method for testing a production code. 

FIG 5 is a diagram of a test sequence of a successful test completion. 
FIG. 6 is a diagram of a test sequence after detection of a failure. 

DETAILED DESCRIPTION 

FIG 1 shows an exemplary programming environment 10. In the programming 

10 environment 10, executable production code 28 is generated from production source code 14. 
Executable test code 20 is generated from test source code 16. 

In software development, a developer generates a common source unit 12 including 
production source code 14. The production source code 14 constitutes the actual software 
functionality (and is intended for a production environment 34 and a development environment 

15 32). The common source unit 12 also includes test source code 16 intended "for the development 
environment 32. The test source code 16 includes test methods 18 for testing the production 
source code 14. Test methods 18 are identified by a key word (test indicator), e.g., "for testing", 
that is an extension to a programming language, described below. 

A compiler 24 converts production source code 14 and test source code 16 into 

20 executable code. During compilation, the compiler 24 checks a global switch 20 (test activation 
switch) to determine whether to generate an executable code unit 31 having both executable 
production code 28 and executable test code 30 or an executable code unit 33 with the executable 
production code 28 alone. 

A syntax check during compilation can recognize static references from the production 

25 source code 14 to the test source code 16 and stop the compilation by producing a message 

indicating a syntax error. Upon receiving the syntax error, a developer can remove those static 
references. If the compilation proceeds with no syntax errors, the compilation generates 
executable code unit 31 in the development environment 32, including the executable test code 
28 (if the global switch 20 is set to an "ON" state or activated). If the global switch 20 is set to 
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an "OFF" state or deactivated (by default in the production run time environment 34), the 
compiler 24 generates executable code unit 33 without the executable test code 30. 

To test the executable production code 28, the executable code unit 31 includes 
executable production code 28 and executable test code 30. The development runtime 
5 environment 32 recognizes global switch 20, executes the executable test code 30 and performs 
the tests directed by the executable test code 30. Because the executable test code 30 is 
embedded with the executable production code 28 in executable code unit 31, the executable test 
code 30 has unrestricted access to all functionality of the executable production code 28. 

The production source code 14 must not include references to the test source code 16: if 

10 the final code is not thoroughly checked in order to prevent reference from test code 30 to 

production code 28 the following defect occurs. While in the development environment 32 the 
executable test code 30 is loaded, in the production system 34, the executable test code 30 is not 
loaded and attempts by the production code 28 to access test code 30 will fail because the test 
code 30 is not loaded in the production environment 34. This causes runtime errors in production 

15 systems where problems need to be detected. 

In the production environment 34, only executable production code 28 is loaded. The 
tests performed by the executable test code 30 are not needed during normal production usage of 
a software system and only used for quality assurance. If the tests are not needed, system 
performance is improved without loading the executable production code 28 containing 

20 executable test code 30 as memory consumption is reduced. 

As described above, the syntax check function of the compiler 24 detects static references 
from the production source code 14 to the test source code 16. Dynamic references are detected 
during execution of the executable production code 28 in the production environment 34 or in 
the development environment 32. If the run time system of development environment 32 or 

25 production environment 34 detects a dynamic reference, i.e., if executing production code 28 
attempts to access parts, objects or functional code of the executable test code 30, then the run 
time system generates a runtime error aborting the running process and yielding an error message 
indicating the occurrence of such a dynamic reference. 

An example production environment 34 includes a run time system such as a virtual 

30 machine (VM) as part of the JAVA environment from Sun Microsystems or .NET from Microsoft 
Corporation. Source code includes software instructions that can be written in a programming 
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language such as a procedural programming language including C, Fortran and Pascal, an object 
oriented programming language such as advanced business application program language 
(ABAP) from SAP AG, JAVA programming language from Sun Microsystems, C++ 
programming language, C# programming language or other programming languages. The 
5 techniques of the programming environment 10 can be implemented for a xUnit test framework 
such as JUnit for JAVA programming language from Sun Microsystems and ABAP Unit for the 
ABAP programming language from SAP AG For example, in a JAVA or .NET environment, the 
compiler 24 is a separate component of the run time system producing two separate byte code 
units, i.e., a byte code unit (or common intermediate language code unit) for production code and 

10 a byte code unit for test code (or common intermediate language code unit). 

FIG 2 shows an example of production source code 14 and test source code 16. The 
production source code 14 includes software instructions for implementing an application, such 
as a business program for an enterprise, whereas test source code 16 includes software 
instructions for testing the production source code 14 in the development environment 32. The 

15 example, which is written in ABAP programming language, includes an asterisk (*) for 

introducing comments in plain test explaining the code and is disregarded by the compiler. The 
production source code 14 includes class definition 14a and class implementation 14b. The class 
definition 14a declares a production method ADD which is defined in the respective class 
implementation 14b. In this example, the method ADD adds two import parameters A and B and 

20 yields the result in an export parameter RESULT. 

The test source code 16 implements a test class. This test class includes a test class 
definition 18a and a test class implementation 18b. The class is defined with the extension "for 
testing". The extension identifies the class as a test class so that the compiler 24 can distinguish 
it from the production source code 14. The test class definition 18a declares a test method 

25 TEST_ADD. The extension "for testing" identifies this method as a test method. The test 

methods can be called from test tools of a development environment when performing the tests. 

The test class implementation 1 8b defines the test method TEST_ADD that is declared 
by the class definition. The test method TEST_ADD represents a method that tests the 
production method ADD of the production code 14. The test method TEST_ADD calls the 

30 production method ADD with parameter values, e.g. the parameter A set to a value of "3" and the 
variable B set to a value of "5." The result of the call to the production method ADD is assigned 
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to the variable ACTUAL_RESULT for subsequent comparison. The test class implementation 
1 8b then uses the test assertion method ASSERT_EQUALS for comparing the value represented 
by ACTUAL_RESULT and passes to the parameter act with the expected value passed to the 
parameter EXP. This test assertion method is one of a series of assertions provided by utility 

5 class CL_AUNIT_ASSERT that is part of the ABAP programming environment. This utility 
class is part of the unit test framework "ABAP Unit" (Other test assertions are verified by 
methods from CL_AUNIT_ASSERT such as ASSERT JNITIAL, ASSERTJBOUND or just 
FAIL unconditionally). If the value passed to ACT is not equal to the value passed to EXP, then 
the test assertion method ASSERTJEQUALS generates a message with the test specified by the 

10 parameter MSG indicating that the test failed or an error has been detected. If the value of ACT 
is equal to the value of EXP, then the test assertion method ASSERT_EQUALS returns without 
generating a message MSG indicating that the test was successful. Thus, the production method 
ADD, if operating properly, returns a result of "8" based on adding "3" and "5." If the 
production method ADD is not operating properly, the test assertion method ASSERTJEQUALS 

15 detects this failure condition and yields a warning message. 

FIG 3 illustrates an exemplary test hierarchy 80 for testing a program. The test hierarchy 
80 is implemented in an ABAP Unit test programming environment. At a lowest level, the test 
hierarchy 80 provides test methods 82 having test assertion (expressed by calling the respective 
test assertion methods) for testing production code. The test methods 82 are part of test classes 

20 84 which are in turn are part of the program frames 86. The program frames 86 are further 

grouped into a test task 88. The test hierarchy 80 can be implemented using an object oriented 
programming language such as ABAP, JAVA, C++, C# and the other programming languages. 

FIG 4 is an exemplary call of a test assertion method ASSERTJEQUALS 56 provided by 
the ABAP Unit utility class CL_AUNIT_ASSERT. The method 56 can be used for verifying test 

25 assertions for the behavior of the production source code 14. A developer implements 

production source code 14 that, for example, performs particular operations on data and produces 
a result of the operations. The production source code 14 can include a method that performs an 
addition operation on two numbers and returns the result to a calling program. The developer 
may wish to test the addition operation over a range of numbers including extreme values such as 

30 zero and negative numbers. In this example, the test assertion method ASSERT_EQUALS 56 is 
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used to compare an expected result EXP_RESULT from production code 14 with an actual result 
ACTUAL_RESULT returned from the production code being tested. 

The test assertion method ASSERT EQUALS 56 is similar to the test assertion method 
ASSERT_EQUALS in FIG. 2. However, in this example, an optional parameter 57 is supplied 
5 which otherwise is set to a default value. The optional parameter 57 provides the developer an 
ability to control the flow of a test execution and to decide at which level the test flow should be 
interrupted. The optional parameter 57 can be set to one of several constant, predefined values 
QUIT_VALUES 58 for controlling the flow of a test. For example, if the optional parameter 57 
is set to the value of "NO" (parameter passing: QUIT = NO), then the current test method 

10 continues with the next statement inside the function regardless of whether the test assertion was 
triggered by an error. The default behavior (and the traditional behavior of xUnit 
implementations) causes an interruption of the current test method in case of a failure. This is 
also the case if the optional parameter 57 is set to a value of "METHOD." If the optional 
parameter 57 is set to a value of "CLASS," in the event of a detection of a failure, the current test 

15 class is interrupted. Likewise, if the optional parameter 57 is set to the value of "PROGRAM," 
then, in the event of failure detection, the execution of all test classes associated with this 
particular program is abandoned. As a result, test execution of a test hierarchy can be controlled 
when a failure condition is detected in production code. 

FIG 5 shows an exemplary test sequence diagram 100 of a successful test completion of 

20 a test hierarchy as applied to production source code 14. The test sequence diagram 100 
illustrates a test sequence or test flow similar to the test hierarchy 80 of FIG. 3 as it is 
implemented in an ABAP Unit programming environment. It should be noted that only a portion 
of the test hierarchy is described to simplify the discussion. The test hierarchy is organized 
according to a test task 88 having a program frame 86a, which in turn, further includes a test 

25 class 84a having test methods 82a and 82b. The test method 82a includes test assertions 81a and 
81b. In a similar manner, test method 82b includes test assertion method calls 81c and 8 Id. It 
should also be noted that other test hierarchy configurations are possible in other programming 
language environments. In operation, the test hierarchy is applied to production source code to 
test the functionality of the code. 

30 FIG 5 illustrates a result of each test assertion method 81 is successful indicating that the 

method has not detected any failures or errors in the production source code 14. For example, 
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the result of the execution of test assertion method 81a is successful as indicated by the reference 
Success. FIG 5 illustrates that the complete test hierarchy is traversed so that all the tests are 
completely executed. 

FIG 6 illustrates an exemplary test sequence diagram 200 of a test hierarchy after 
5 detection of failures in a production code. In this example, the test flow begins with the 

execution of test assertion method 81a. The test assertion methods called in this example can be 
the test assertion method ASSERT_EQUALS 56 of FIG 4 specifying the optional parameter 57 
to a value of "NO/' "METHOD/' "CLASS" and "PROGRAM" respectively. A failure detection 
condition in the production source code is indicated by the reference "Failure" and a non-failure 

10 condition is indicated by the reference "Success". A failure condition is defined when 

production code fails to produce an expected result. Test assertion 81a quit behavior is set to a 
value of "NO", specifying that if a failure is detected, the next test method should be executed, 
which in this case is test assertion method 81b. More specifically, the optional parameter is set 
to the value of NO. However, to simplify the description, setting the test assertion quit behavior 

15 to a value means setting this optional parameter to the respective value. 

Since test assertion method 81b is successful, the test flow continues onto the next test 
assertion method, which is test assertion method 81c. Test assertion method 81c is associated 
with test method 82b under test class 84a. Test assertion method 81c is executed, and like test 
assertion method 81b, it also detects a failure condition. However, the test assertion 81c quit 

20 behavior is set to the value of "METHOD." As a result, test assertion method 8 Id is skipped and 
execution resumes at the next test method 82c with test assertion 81e being executed. The test 
assertion method 81e detects a failure condition. Since the value of this test assertion 81e quit 
behavior is set to a value of "CLASS," execution is forced to resume at the next test class 84b 
causing the remaining test assertion 81f as well as the next test method 82d to be skipped. Under 

25 test class 84b, test assertion method 81g is executed, which detects a failure. Since the value of 
test assertion 81g quit behavior is set to a value of "PROGRAM," testing is forced to resume at 
the next program frame 86b. As a consequence, any remaining test methods in program frame 
86a are aborted. Thus, the above described flow control is achieved by specifying an optional 
parameter, in this case, the optional parameter. 
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The above is intended as an example and other configurations are possible such as 
providing more than one assertion method with different names instead of the optional 
parameter. 

Embodiments of the invention can be implemented in digital electronic circuitry, or in 
5 computer hardware, firmware, software, or in combinations of them. Embodiments of the 

invention can be implemented as a computer program product, i.e., a computer program tangibly 
embodied in an information carrier, e.g., in a machine-readable storage device or in a propagated 
signal, for execution by, or to control the operation of, data processing apparatus, e.g., a 
programmable processor, a computer, or multiple computers. A computer program can be 

10 written in any form of programming language, including compiled or interpreted languages, and 
it can be deployed in any form, including as a stand-alone program or as a module, component, 
subroutine, or other unit suitable for use in a computing environment. A computer program can 
be deployed to be executed on one computer or on multiple computers at one site or distributed 
across multiple sites and interconnected by a communication network. 

1 5 Method steps of embodiments of the invention can be performed by one or more 

programmable processors executing a computer program to perform functions of the invention 
by operating on input data and generating output. Method steps can also be performed by, and 
apparatus of the invention can be implemented as, special purpose logic circuitry, e.g., an FPGA 
(field programmable gate array) or an ASIC (application-specific integrated circuit). 

20 Processors suitable for the execution of a computer program include, by way of example, 

both general and special purpose microprocessors, and any one or more processors of any kind of 
digital computer. Generally, a processor will receive instructions and data from a read-only 
memory or a random access memory or both. The essential elements of a computer are a 
processor for executing instructions and one or more memory devices for storing instructions and 

25 data. Generally, a computer will also include, or be operatively coupled to receive data from or 
transfer data to, or both, one or more mass storage devices for storing data, e.g., magnetic, 
magneto-optical disks, or optical disks. Information carriers suitable for embodying computer 
program instructions and data include all forms of non-volatile memory, including by way of 
example semiconductor memory devices, e.g., EPROM, EEPROM, and flash memory devices; 

30 magnetic disks, e.g., internal hard disks or removable disks; magneto-optical disks; and CD- 
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ROM and DVD-ROM disks. The processor and the memory can be supplemented by, or 
incorporated in special purpose logic circuitry. 

Other embodiments are within the scope of the following claims. 
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